AttachSourceFrame

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

AttachSourceFrame
The AttachSourceFrame method should associate a source frame with a display frame for this part.
void AttachSourceFrame (in ODFrame frame,
                        in ODFrame sourceFrame);
frame
A reference to a display frame for this part.
sourceFrame
A reference to a display frame to be used as the source for the display frame specified in the frame parameter.

DISCUSSION
This part's containing part calls this method. This method tells this part to keep two or more of its display frames synchronized. The containing part calls this method immediately after creating a new display frame for this part.
Your part's AttachSourceFrame method should perform any actions necessary to synchronize the frames. If the two frames have identical presentations, your method should copy all embedded frames in the source frame into the other frame (and attach the copied embedded frames to their source frames by calling the embedded part's AttachSourceFrame method).

OVERRIDING
When you subclass ODPart, you must override this method. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely.

EXCEPTIONS

kODErrInvalidFrame
The specified frame is not a display frame of this part.

SEE ALSO
"The AttachSourceFrame Method" on page 60 in OpenDoc Cookbook.
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"Synchronizing Display Frames" on page 114 in OpenDoc Programmer's Guide.
"Synchronizing Embedded Frames" on page 124 in OpenDoc Programmer's Guide.